Skip to content

Conversation

howard-e
Copy link
Contributor

@howard-e howard-e commented Jul 30, 2025

Closes #3293

Additionally, this PR ensures the pages that /content/shared/templates/read-this-first.html appears on is controlled from this repository with the new /shared/js/read-this-first.js script. That was being done from w3c/wai-aria-practices by manually adding the template into the patterns and practices index pages. This was discussed in Jul 22, 2025 TF meeting.

The script is doing the same by inserting the template content after the first h1 found on the page.

This PR means the insertion from w3c/wai-aria-practices should be removed. Note that this should be reviewed and merged before w3c/wai-aria-practices#422 is merged.


WAI Preview Link (Last built on Tue, 19 Aug 2025 16:56:44 GMT).

@howard-e howard-e added the Infrastructure Related to maintaining task force and repo operations, processes, systems, documentation label Jul 30, 2025
@howard-e howard-e changed the title Infrastructure: Control pages read-this-first.html appears from APG Infrastructure: Control pages read-this-first.html appears on from APG Jul 30, 2025
Copy link
Contributor

@jongund jongund left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me

@css-meeting-bot
Copy link
Member

The ARIA Authoring Practices (APG) Task Force just discussed Issue 3293: Adding "Read This First" link to the top of each pattern page.

The full IRC log of that discussion <jugglinmike> Topic: Issue 3293: Adding "Read This First" link to the top of each pattern page
<jugglinmike> github: https://github.com//pull/3320
<jugglinmike> Matt_King: Everything looks good, here. We have all the necessary reviews, so thanks to everyone for that
<jugglinmike> Matt_King: This work is tricky to merge, though, because it requires coordination between two repositories
<jugglinmike> howard-e: This patch can land before the corresponding pull request to the "build" repository. Still, I would advise not to merge this until that review is complete
<jugglinmike> Matt_King: When the review is complete there, can you comment on this issue and say that it's safe to merge?
<jugglinmike> howard-e: Sure
<jugglinmike> Matt_King: Great. I think this is really good. I think it's a very positive change.

@mcking65
Copy link
Contributor

@howard-e are we ready for this to land yet?

@mcking65 mcking65 changed the title Infrastructure: Control pages read-this-first.html appears on from APG Pattern Pages: Show link to "Read This First" just after the H1 on each pattern page Aug 19, 2025
@howard-e
Copy link
Contributor Author

howard-e commented Aug 19, 2025

@howard-e are we ready for this to land yet?

@mcking65 not as yet. Still awaiting a review on the builder side that's being prioritized for today

@howard-e
Copy link
Contributor Author

@mcking65 the related build repo PR#422 has been approved so this PR is ready to be merged.

@mcking65 mcking65 merged commit 457f47a into main Sep 2, 2025
16 checks passed
@mcking65 mcking65 deleted the read-this-first-at-source branch September 2, 2025 16:41
@mcking65 mcking65 added enhancement Any addition or improvement that doesn't fix a code bug or prose inaccuracy Pattern Page Related to a page documenting a Pattern labels Sep 2, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement Any addition or improvement that doesn't fix a code bug or prose inaccuracy Infrastructure Related to maintaining task force and repo operations, processes, systems, documentation Pattern Page Related to a page documenting a Pattern
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Consider adding "Read This First link to the top of each pattern page"
4 participants